entry: Set GTK_STYLE_CLASS_OSD on text selection popovers

popover: Do not set GTK_STYLE_CLASS_OSD directly

That's up to the caller, popovers are by design not only meant to
have that role.

popover: Fix allocation of CSS margins

that was forgotten about, leaving no room for theme shadows that'd
make popovers look less flat.

popover: Flip popovers positioning on left/right on RTL.

If widgets have GTK_TEXT_DIRECTION_RTL, popovers being positioned
on GTK_POS_LEFT/RIGHT will default to appearing on the other side
too.

window: Remove popovers on dispose() before unsetting focus.

The popovers may return keyboard grabs to previous widgets, so if
called after unsetting the focus, the window may be left with a
dangling GtkWidget that would cause crash at later dispose() calls.

entry: Improve positioning of touch selection magnifier

Always show completely above or below entry to avoid covering
content, and limit horizontal position so it doesn't overflow
to the right.

Implement wfh functions

With only get_preferred_width and get_preferred_height implemented,
we end up calling the GtkBin height_for_width implmementation, which
knows nothing about the margins and paddings that GtkPopover needs.
As a result, a listbox added to a popover was getting cut off
at the bottom.

popover: Remember last focused widget on the toplevel when a popover is shown

This is so the previously focused widget can regain focus when a modal popover
is dismissed.

popover: Add a "modal" boolean property to GtkPopover

This property is TRUE by default, when a popover is modal, it
will automatically set a GTK+ grab on the popover, and grab
the keyboard focus into the popover.

gtk-demo: Fix crash after running popovers demo

The GtkBuilder window containing the complex popover UI was left
dangling, and with a dangling pointer to its former child, causing
crashes on gtk_grab_notify() after the popover was destroyed.

popover: Fix memory management of popovers

Popovers are strange in the sense that they aren't attached to a
parent directly, they rely on the relative_to widget so the toplevel
is shared, and when they have a parent, it is the toplevel itself,
not relative_to. This also means that there are conditions where the
popover loses it's parent, so they must survive unparenting.

The previous code would be floating the last reference as soon as the
parent is gone, but it was non-obvious who'd own that reference. So
fix this situation by granting the ownership of popovers to their
relative_to widget, an extra reference may be held by the toplevel
when the popover has a parent, but the popover object will be
guaranteed to be alive as long as the parent lives.

This way, memory management of popovers is as hidden from the user
as regular widgets within containers are, users are free to call
gtk_widget_destroy() on a popover, but it'd eventually become
destructed when relative_to is.

popover: Implement keyboard focus behavior

When a popover is focused, the focus is forwarded so the first
child what would get the focus actually gets it. Also, implement
correct focus chain, so the keyboard focus stays within the popover
when navigating with keyboard.

texthandle: Fix arguments in ::style-updated callback

gtkmain: Let windows handle WM-related events before delivering to the grab_widget

This makes it possible to move/resize client-side decorated windows that are
otherwise obscured by a GTK+ grab somewhere else, either a popover within the
window itself or a modal dialog above the window.

entry: Show a GtkMagnifier popover on touch selection

texthandle: Remove relative_to API

It's unused now, GtkTextHandle uses widget coordinates.

texthandles: Use GtkWindow popovers API

This offers the same behavior, but GDK_WINDOW_TEMP windows aren't used
anymore, involving less translations from/to root coordinates, plus no
glitches in having handles snap to content as windows move.

window: Keep track of popover children mapped status

In order to maintain visibility of the GdkWindow that's the parent window
of the popover widget.

window: Add gtk_window_get_popover_position()

A getter to complement the setter

entry: Set use-underline in popover GtkToolButtons

textview: Set use-underline in popover GtkToolButtons

textview: Use GtkMagnifier on touch selection

The magnifier renders the area covered by the finger, making it easier to follow
the text being selected.

Add GtkMagnifier

This is a private widget that takes another widget on construction, and is able
to render parts of it, possibly at a different magnification level.

pixelcache: check whether cached surface and cairo_t scales match

gtk-demo: Add GtkPopovers demo

In this demo several widget create popovers with different complexities,
positions, and grabbing behavior.

popover: Add documentation

popover: Honor GtkContainer::border-width

The border width is now set around the contained widget.

popover: remove GTK+ grab (if any) on unmap

If there is a GTK+ grab on the popover, ensure that it's removed when it's
unmapped. If no GTK+ grab was performed on the popover, this function will
do nothing.

popover: listen harder on the widget being pointed to

Hierarchy, size allocation and widget visibility are now listened
to in order to update the popover state accordingly.

Introduce GtkPopover

Now that the GtkBubbleWindow object has been cleaned up and made
more generic, rename it as GtkPopover and make it public.

bubblewindow: Remove popup/popdown() APIs

Those functions aren't as useful anymore, hiding/showing can be
controlled by setting the widget visibility, and grabbing can be
achieved by performing a GTK+ grab.

entry: Avoid bubblewindow popup/popdown API

Besides setting all positioning properties at once, popup() would just
show the widget, so do that directly after just updating the position.

textview: Avoid bubblewindow popup/popdown API

Besides setting all positioning properties at once, popup() would just
show the widget, so do that directly after just updating the position.

bubblewindow: Point to the entire widget area by default

This way pointing_to is not fully needed, unless you're pointing
to an specific rectangle within the widget, passing NULL would unset
the region too.

bubblewindow: check the border-radius when rendering the bubble tail.

bubblewindow: Improve overflow cases

If the bubble window doesn't fit into one direction, it must
lay at the other side of the pointed_to rectangle.

bubblewindow: Make it relative to GtkWidget coordinates

GdkWindows are gone now from the API, the pointed_to rectangle
is from now on relative to the widget allocation. GtkTextView
and GtkEntry were updated to adapt to this change.

bubblewindow: Remove grab API

This is not as necessary now that bubble windows are popovers, if
a modal behavior is wanted on popover contents, a GTK+ grab on the
popover widget will suffice.

bubblewindow: Turn into a GtkWindow popover

This way GtkBubbleWindows are rendered on top of all window content, without
the need of a GDK_WINDOW_TEMP window.

window: Add lowlevel popovers API

Popovers are transient floating widgets that are confined to the
window space. These have their own GdkWindow that is set on top
of the regular window contents, so they can be used for popup menu
alike UIs with custom popup/popdown/grabs behavior.

docs: fix improper description of GtkTreeModel "rows-reordered" iter

https://bugzilla.gnome.org/show_bug.cgi?id=698398

docs: don't use property syntax for child properties

docs: use correct syntax for signals

docs: don't use property syntax for style properties

docs: mark gtkdoc blocks as private for internal only API

docs: don't reference nonexisting type in docs

docs: don't try to link vfunc

docs: fix links to docs

docs: fix docs link

docs: don't reference api that doesn't exist

docs: don't refer to NO_WINDOW as type

docs: fix dnd docs links

docs: don't use signal syntax for properties

docs: don't use property syntax for child properties

docs: fix links in builder docs

docs: fix signal link syntax

Use the memory settings backend for make check

The color chooser test is constantly running into the
problem that the custom color setting is not empty.
Avoid that by using the memory settings backend.

Use symbolic icon for file chooser

https://bugzilla.gnome.org/show_bug.cgi?id=722642

Remove the use of stock icons from widget templates

https://bugzilla.gnome.org/show_bug.cgi?id=722642

GtkActionBar: Fix center widget visibility handling

This is the same fix that was applied to GtkHeaderBar
recently. Adding a child widget should not make it
visible as a side-effect.

Make GTK_TREE_SORTABLE_*_SORT_COLUMN_ID defines instead of enum

This allows it to be more easily documented.

docs: fix typo in signal link

docs: fix docs link

docs: fix style-updated link

docs: fix link to even structures info

docs: remove duplicate member

docs: fix duplicate symbols in docs

docs: remove missing link

docs: remove reference to removed flags

docs: fix bindings docs link

docs: don't try to link to non-API types

docs: don't use signal syntax for vfuncs

docs: don't use property syntax for style property

docs: don't link to removed types

docs: separate suffix from type

docs: don't use signal syntax for properties

docs: don't use signal syntax for child properties

docs: use function instead of removed macro

docs: GDK_WINDOWING is not a type

docs: don't use property syntax to link to vfuncs

docs: remove broken link to docs

docs: fix function link

docs: remove obsolete references

docs: fix typo in argument list

docs: fix link to gdk docs

docs: don't use type syntax on things that aren't

docs: don't refer to types that don't exist

docs: fix selections documentation link

docs: fix see also link

docs: fix function name link

docs: don't try to link to funcs

docs: fix property links

docs: fix function name link

docs: fix type link

docs: fix typo in function name

docs: don't refer to removed properties

docs: fix typo in argument type

docs: remove links that don't exist

docs: fix typo in function name

docs: don't try to link vfuncs